home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / quixx.zip / README.! < prev   
Text File  |  1991-05-16  |  7KB  |  199 lines
  1. PROGRAM:  Quixx
  2. AUTHOR:   Jonathan Kraidin on 2/90
  3. VERSION:  2.03 on 05/16/91
  4. LAST VER: 2.00 on 05/05/91
  5. USE:      TSR Screen Animator
  6. REQUIRES: DOS 3.0 or above (might work with 2.1 and above, but not tested)
  7.       CGA, EGA, VGA
  8.           Extended or Expanded memory strongly recommended
  9.           CGA = 32K, EGA = 64K, VGA = 160K
  10. SOURCE:   ASSEMBLY
  11.  
  12.  
  13. 1. USE:
  14.  
  15.   This is a TSR program that generates a beautiful selection of vapor-
  16.   like trails after a given idle period.  A simple help file can be called by
  17.   typing QUIXX ? at the DOS prompt.  The program is loaded into memory with:
  18.   QUIXX TimeOut Mode
  19.  
  20.   OR
  21.  
  22.   QUIXX Special (after the Quixx is already loaded)
  23.  
  24.   where TimeOut is the idle time in minutes (1 to 99) and Mode is from
  25.   0 to 19. Modes 1 through 15 select a constant color display for the QUIXX
  26.   using a color palatte corresponding to the Mode.  That is Mode 2 = color 2.
  27.  
  28.   Mode 0 selects an alternating color display.  Every time the Quixx pattern
  29.   bounces off of a wall the color increments.  Mode 16 selects a pattern where
  30.   the colors vary within each line of the Quixx pattern.  This yields a
  31.   constantly changing image as the vapor trail moves.  Mode 17 selects the
  32.   same pattern-type, but in VGA mode19, allowing 256 colors.  The resolution is
  33.   320x200.  Mode 18 is also in VGA mode19, but here the lines of the vapor
  34.   trail are solid.  As a new lines are drawn they go go through all 256 colors.
  35.  
  36.   Mode 19 is the Glide mode.  Here the Quixx pattern is one color,
  37.   but as the image moves its color goes through a continuous spectrum of 384
  38.   shades.  THIS IS A GREAT MODE.
  39.  
  40. 2. SUMMARY OF COLOR MODES:
  41.  
  42.    0       Alternating Colors
  43.    1 - 15  Default Colors in Palette
  44.    16      High Resolution Pattern1
  45.    17      Vga Mode19 Pattern1 (320x200)
  46.    18      Vga Mode19 Pattern2
  47.    19      Glide Mode (Recommended Mode)
  48.  
  49. 3. EXAMPLES OF OPTIONS
  50.  
  51.   The options can be changed at any time by retyping the command.  So if you had
  52.   typed:
  53.  
  54.   QUIXX 2 15
  55.  
  56.   selecting a 2 minute time-out using mode 15, and you then type
  57.  
  58.   QUIXX 5
  59.  
  60.   you change the timeout to 5 minutes and leave the mode unchanged.
  61.   If you typed
  62.  
  63.   QUIXX 5 19
  64.  
  65.   you will have also changed the mode to mode 19.
  66.  
  67. 4. UNLOADING THE TSR
  68.  
  69.   If you wish to unload the TSR type
  70.  
  71.   QUIXX r
  72.  
  73.   This will Remove the TSR from the TSR memory chain, regardless of the number
  74.   of TSRs loaded before or after the QUIXX program.
  75.  
  76. 5. ADDITIONS MADE IN NEWER VERSIONS
  77.  
  78.  
  79.   ENABLE/DISABLE ACTIVITY
  80.  
  81.   Version 1.70 includes an enable/disable feature.  This allows Quixx to remain
  82.   in memory as a TSR but remain dormant.  By typing
  83.  
  84.   Quixx -
  85.  
  86.   the user disables the sleep count-down.  The Quixx will never become active.
  87.   By typing
  88.  
  89.   Quixx +
  90.  
  91.   the Quixx's sleep count-down is re-enabled.  One can use this feature in a
  92.   BATCH file if you want to selectively enable/disable the Quixx without
  93.   changing the programs in active memory.  REMEMBER, Quixx's interrupts are
  94.   still hooked into the BIOS.
  95.  
  96.  
  97.   SPEED CONTROL OF PATTERN
  98.  
  99.   The program automatically adjusts its pattern speed to your processor.  The
  100.   user can now over-ride this with the speed control in Version 1.71. By typing
  101.  
  102.   Quixx f    OR    Quixx s
  103.  
  104.   the user can speed up or slow down the vapor image. This can be repeated
  105.   multiple times to go really FAST or SLOW.  The user will be informed
  106.   when the limit is reached.  The default speed will be used each time the user
  107.   changes the sleep-period or the image color mode.
  108.  
  109. ******************************************************************************
  110.  
  111. IT IS STRONLY RECOMMENDED THAT YOU HAVE EXPANDED OR EXTENDED MEMORY to prevent
  112. memory conflicts when the TSR saves your video screen.  While the program will
  113. use higher memory without EXPANDED memory, the program may crash your system
  114. depending on what applications are running.  This program has worked well using
  115. Expanded Memory with programs like WordPerfect and Harvard Graphics.
  116.  
  117.  
  118.   EXTENDED MEMORY ADDITION
  119.  
  120.   Version 2.00 now senses and uses extended memory.
  121.   Quixx will first check for the expanded memory driver; if not found,
  122.   quixx will check for the extended memory driver, HIMEM.SYS.
  123.   If none of these are found then High
  124.   Memory is used.  Again, if you see the warning message Quixx can cause
  125.   machine crashes.
  126.  
  127.  
  128.   IF USING EXTENDED MEMORY YOU NEED **** HIMEM.SYS *****
  129.   IF USING EXPANDED YOU NEED AN EXPANDED MEMORY DRIVER MEETING THE LIM SPECS.
  130.   IF YOU DO NOT SEE QUIXX DISPLAY THAT IT RESERVED MEMORY FOR ITSELF THERE
  131.     CAN BE CRASHES!
  132.  
  133. 6.  SPECIAL NOTES
  134.  
  135.    If only a CGA is present only the color white is used.  No other modes work.
  136.    Modes 17, 18, and 19 are meant for the VGA and will not work properly on an
  137.    EGA monitor.
  138.  
  139. 7. MOUSE SENSING
  140.  
  141.    Mouse is polled at COM1 and COM2. The port is only checked for
  142.    activity if it is present.  If you are using a Bus Mouse there is a chance
  143.    that your mouse will not be sensed if it is NOT an MS Bus Mouse (InPort
  144.    Mouse) or a Mouse Systems Bus Card.  This is because the mouse protocols
  145.    can be different for each manufacturer.
  146.  
  147. 8. WINDOWS COMPATABLITY
  148.  
  149.    The program as of the above date has been tested briefly with Windows 3.0.
  150.    If you are using a mouse on COM 1 or 2 your mouse will be 'sensed' when you
  151.    move it and Quixx will terminate.  The keyboard should also get you out.
  152.  
  153.    Quixx only works with WINDOWS if you have EXTENDED MEMORY.  In addition,
  154.    Quixx must be loaded before WINDOWS in order to reserve the necessary
  155.    memory for its screen saves.
  156.  
  157.    Because of the means necessary to make Quixx compatable with Windows the
  158.    mouse may not always behave properly with other applications, although this
  159.    is unlikely.  This problem can be solved very simply.  If you are
  160.    EXITING Windows (whether you have a mouse or not) you should use a
  161.    BATCH file that will REMOVE Quixx from memory and then RE-INSTALL it.
  162.    (Quixx r).  Do this only if you are having problems.
  163.  
  164.  
  165. 9. SOURCE CODE AVAILABILITY
  166.  
  167.    The assembly source is available on request.  It is several pages long and
  168.    includes four modules:
  169.  
  170.    1. TSR and DOS interface routines
  171.    2. QUIXX animation routines
  172.    3. Graphics routines/Expaned memory routines
  173.    4. Command line routines
  174.  
  175.    The code is well commented in most parts and can teach the reader about:
  176.  
  177.    .non-reentrant TSRs
  178.    .unloading TSRs
  179.    .accessing Video Memory/saving/restoring
  180.    .reading COM ports
  181.    .using Expanded and Extended Memory
  182.    .writing graphics algorithms
  183.    .reading/writing directly to the CGA/EGA/VGA graphics registers
  184.  
  185.    The program is free to use, copy, and distribute.  The source is only $15
  186.    and well worth it.  If interested write to:
  187.  
  188. Jonathan Kraidin
  189. 3301 Indian Queen Lane
  190. Philadelphia, PA  19129
  191.  
  192. CIS 72571, 2122
  193.  
  194. (As of June 1, 1991 I will no longer be at the above address.  However, I
  195. will still be in the Philadelphia area for one more year.  One can write to
  196. my CIS number to get my address or call information at area code 215 to get
  197. my number.)
  198.  
  199.